Skip to content

Add Naver Commerce API documentation (Python + JavaScript)#171

Open
sjk990515 wants to merge 2 commits intoandrewyng:mainfrom
sjk990515:docs/add-naver-commerce-api
Open

Add Naver Commerce API documentation (Python + JavaScript)#171
sjk990515 wants to merge 2 commits intoandrewyng:mainfrom
sjk990515:docs/add-naver-commerce-api

Conversation

@sjk990515
Copy link
Copy Markdown

@sjk990515 sjk990515 commented Mar 20, 2026

What

Add Naver Commerce API (Smart Store) documentation with Python and JavaScript variants.

Why

Naver Smart Store is the dominant e-commerce platform in South Korea with 500K+ active sellers.
The Commerce API uses a non-standard authentication flow (OAuth2 with bcrypt-based client secret
signatures) that's easy to get wrong without a reference. No existing Context Hub docs cover
Korean e-commerce APIs.

Testing

  • npm test passes (231 tests, 0 failures)
  • chub build content/ --validate-only succeeds (Valid: 1554 docs, 6 skills, 0 warnings)
  • Manual testing done

Notes

  • Two language variants: Python (requests + bcrypt) and JavaScript (axios + bcrypt)
  • Covers the bcrypt signature auth flow, product CRUD, order management, and error handling
  • Product search uses POST (not GET) which is a common source of confusion
  • All date/time examples use KST (UTC+09:00) format as required by the API

Adds curated docs for the Naver Commerce API (Smart Store) covering
authentication with bcrypt-signature OAuth2, product CRUD, order
management, error handling, and KST date formatting.

Two language variants: Python (requests + bcrypt) and Node.js (axios + bcrypt).
- versions: "v2" -> "1.0.0" to match project-wide semver convention
- Remove non-standard "--" from description field
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant